开发者档案 - API对接指南

接口概述

小企鹅验证API提供卡密登录、卡密解绑、应用公告三大核心功能，采用RC4加密传输，支持多语言快速对接，全程保障数据传输安全。

基础对接信息

核心接口地址

https://xqe.siyecaolmh.top/api/api.php

数据传输方式

RC4加密传输（后台可配置加密开关），加密/解密密钥从应用后台获取

公共请求参数

核心接口详情

注：所有接口需通过type参数指定接口类型，拼接在接口地址后

1. 应用公告查询

接口类型

type=app_announcement

返回结果（解密后）

{ "code": "3", "msg": "公告内容", "now_time": 时间戳, "md5_check": "MD5验证串" }

2. 卡密登录验证

接口类型

type=kami_login

必传额外参数

kami（用户卡密） + imei（设备唯一标识）

返回结果（解密后-成功）

{ "code": "16", "msg": "卡密登录成功", "now_time": 时间戳, "vip_time": 会员到期时间戳, "md5_check": "MD5验证串" }

3. 卡密设备解绑

接口类型

type=imei_relieve

必传额外参数

kami（用户卡密） + imei（绑定设备标识）

返回结果（解密后-成功）

{ "code": "10", "msg": "卡密解绑成功", "now_time": 时间戳, "imei_relieve_reduce_time": 扣除时长(小时), "md5_check": "MD5验证串" }

完整错误码说明

通用对接流程

1. 从后台创建应用，获取APPID、APPKEY、加密密钥；
2. 根据开发语言，实现POST网络请求，传递公共参数+接口专属参数；
3. 接口返回数据后，使用加密密钥进行RC4解密；
4. 解析JSON结果，根据code错误码处理业务逻辑；
5. 可选：通过md5_check验证返回数据完整性。

对接核心注意事项

• 设备IMEI需保证唯一性，建议使用设备硬件标识（如Android ID、UUID），避免重复；
• 若后台开启免费模式，卡密登录接口将直接返回成功（code=16），无需验证卡密有效性；
• 卡密解绑后，会按后台配置扣除一定时长，具体以返回的imei_relieve_reduce_time为准；
• 所有接口请求超时建议设置为5-10秒，避免网络问题导致请求阻塞；
• 加密开关由后台控制，若关闭加密，接口将直接返回明文JSON，无需解密。